home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / APP / A-D / Attention 1.0.1.sit / Attention Read Me next >
Text File  |  1993-02-19  |  3KB  |  57 lines
  1. About Attention 1.0.1
  2. ===================
  3.  
  4. Attention is a control panel that lets you control the way inactive applications (i.e., applications running in background) behave when they need user attention.  In particular, Attention lets you choose which sound is played when a background application wants to tell you something.  Without Attention, this sound would be the system beep most of the times.  You can also use Attention to disable sound altogether or to prevent background applications to put up an alert box.
  5. To use Attention, you need System version 6.0.4 or better.  Drag Attention onto the System folder icon.  If you're running System 7, Attention goes to the Control Panels folder, otherwise it goes in the System folder.  You need to reboot the machine to use Attention.
  6.  
  7.  
  8. Changes from version 1.0
  9. ======================
  10.  
  11. * In version 1.0, when the “Always Audible” option was turned on, Attention would prevent After Dark from starting screen saving activity (After Dark uses the Notification Manager in strange ways!).  This conflict has been fixed.
  12.  
  13. * Attention didn’t work properly when using Carpetbag and Outboard Sound by James Walker: the sounds stored outside the System suitcase wouldn’t appear in the control panel list.  This problem has been fixed.
  14. However, if you use Attention with Carpetbag (or with any extension that allows you to store sounds outside the System suitcase), you should ensure that Attention loads AFTER the other extension, not before.
  15. A way to do this is to rename one of the two, e.g. rename “Attention” to “Ten Shun” :-)
  16.  
  17.  
  18. A Note For Programmers
  19. ======================
  20.  
  21. Attention patches _NMInstall (0xA05E) and installs a new gestalt selector ('NMBT') at startup time.  The response value returned by this gestalt selector is a pointer to a parameter block in the system heap, whose structure is given below as a Pascal record:
  22.  
  23. TYPE
  24.  
  25.   AttnParamBlock = RECORD
  26.     attnVersion: Integer;
  27.     attnDaisyChain: ProcPtr;
  28.     attnSoundHandle: Handle;
  29.         attnSoundID: Integer;
  30.         attnFlags: SignedByte;
  31.    end;
  32.  
  33. * AttnVersion is the version number of the gestalt function installed by Attention, expressed in BCD.  Current version is 1.0 (0x100).  Always check the version number before trying to access other fields.  If the version number isn't 0x100, do not assume that any of the fields contains valid information.
  34.  
  35. * AttnDaisyChain is the address of the original _NMInstall trap.
  36.  
  37. * AttnSoundHandle is a handle to the 'snd ' resource to be played when a notification is posted.
  38.  
  39. * AttnSoundID is the resource ID of the 'snd ' resource.
  40.  
  41. * The low-order four bits of attnFlags reflect the settings of the four check boxes in the Attention control panel (always audible, disable sound, no alert boxes, startup icon).
  42.  
  43. All the fields are read-only.
  44.  
  45.  
  46. Acknowledgements
  47. ================
  48.  
  49. Attention was written by Marco Piovanelli.
  50. You can contact him at the following addresses:
  51.  
  52. Internet: piovanel@ghost.dsi.unimi.it
  53. Mail: 26 via del Sebino, 25126 Brescia, Italy
  54.  
  55. Paul Mercer et al. wrote the standard ShowINIT code used for showing the startup icon.
  56. Maynard Handley pointed out the conflict with Carpetbag.
  57. Special thanks are due to René Ros for testing, support and encouragement.